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FOREWORD 


This  Is  one  of  three  technical  reports  being 
published  simultaneously.  The  others  are  the  MILITRAN 
Programming  Manual  (Technical  Documentary  Report  No, 
ESD-TDR-64-320)  and  the  MILITRAN  Reference  Manual 
(Technical  Documentary  Report  No,  ESD-TDR-64-390) .  The 
three  reports  constitute  a  complete  description  and  In¬ 
structions  for  using  the  MILITRAN  language  In  computer 
programming  of  simulation  problems. 

The  MILITRAN  7090-7094  Processor,  which  Is  used 
to  compile  a  problem  written  In  MILITRAN  source  language 
Into  a  machine  language  program,  will  be  available  to  pro¬ 
spective  users.  Pending  final  arrangements,  requests  for 
Information  about  the  MILITRAN  Processor  should  be  sent  to 
the  Office  of  Naval  Research  (Code  491). 

This  report  was  prepared  by  the  Systems  Research 
Group,  Inc.,  under  Contract  Nonr-2936(00),  which  was  Inltl 
ated  by  the  Naval  Analysis  Group,  Office  of  Naval  Research 
and  has  been  Jointly  supported  by  the  Office  of  Naval 
Research  and  the  Electronic  Systems  Division,  Air  Force 
•Systems  Command. 


ABSTRACT 


MILiraAN  18  an  algorithmic  computer  language 
specifically  oriented  to  the  problems  encountered  In 
simulation  programming.  In  addition  to  providing  over¬ 
all  flexibility  In  expressing  complex  procedures,  the 
language  contains  features  which  greatly  simplify  the 
malntalnence  of  status  lists,  handling  of  numeric  and 
non-nuraerlc  data,  and  sequencing  of  events  In  simulated 
time . 

This  report  describes  the  features  and  operating 
procedures  of  the  7090-9^  MILITRAN  Processor. 


REVIEW  AND  APPROVAL 


This  Technical  Documentary  Report  has  been 
reviewed  by  the  Electronic  Systems  Division,  U.  S,  Air 
Force  Systems  Command,  and  Is  approved  for  general  distribu¬ 
tion. 
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INTRODUCTION 


This  manual  describes  features  of  the  709O 
MILITRAN  Processor  and  provides  Instzniotlons  for  Its 
use,  General  knowledge  of  both  MILITRAN  and  the  IBM 
7090  are  assumed  on  the  part  of  the  reader. 

The  manual  Is  divided  Into  three  major  sections. 
The  first  of  these  provides  an  overall  view  of  the  processor 
and  Its  operation.  Two  subsequent  sections  cover  details 
of  processor  operation  which  apply  to  the  programmer  and 
machine  operator  respectively. 

Pull  Information  necessary  for  compilation, 
assembly  and  execution  of  programs  written  in  the  MILITRAN 
language  Is  contained  herein. 
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ms  7090  MILITEIAN  PROCESSOR 

Th®  7090  MILITRAN  Processor  permits  the  use  of 
MILITRAN  Basic  Language  In  programming  algorithms  for  the 
IBM  7090/r094,  Hie  processor  translates  programs  written 
In  MILITRAN  Into  PAP,  the  7090/709^  assembly  language, 

Ihls  section  of  the  MILITRAN  Operations  Manual 
describes  the  machine  environment  required  by  the  processor, 
the  output  obtainable  from  the  processor,  and  the  general 
structure  of  the  processor, 

PROCESSOR  ENVIRONMENT 

Hie  processor  has  been  designed  to  operate  within 
the  framework  of  procedures  commonly  In  use  at  scientific 
Installations  using  the  7090,  Hardware  and  software  require¬ 
ments  of  the  processor  are  specified  In  this  subsection. 

Hardware  Requirements 

Ihe  basic  hardware  requirement  for  the  processor 
Is  an  IBM  7090  or  7094  having  the  following  on-line  equipment: 

1.  Two  IBM  7607  Data  Channels 

2.  Ten  IBM  726  Magnetic  Tape  Units 

3.  One  IBM  716  Line  Printer 
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Tape  units  are  distributed  equally  between  the  channels, 
and  the  printer  is  attached  to  channel  A. 

Although  the  hardware  configuration  described 
above  is  commonly  available,  the  basic  design  of  the 
processor  would  permit  modifications  reducing  hardware 
requirements  to  an  IBM  7090  with  seven  tape  units.  An 
attendant  loss  in  speed  and  convenience  would,  of  course, 
accrue  from  such  modification. 

Programs  compiled  by  the  processor  permit  the 
use  of  an  on-line  card  reader  and  punch  where  available. 

Software  Requirements 

The  processor  operates  as  a  normal  "chain- Job" 
under  the  FORTRAN  Monitor  System.  MILITRAN  compilations 
may  be  Included  in  ordinary  monitor  mins  without  conflict. 
Use  of  other  monitor  sub-systems  is  not  impaired. 

Use  of  tapes  by  the  compiler  is  in  accordance  with 
standard  IBM  tape  assignments.  Input/output  routines  used 
by  compiled  programs  Incorporate  a  unit  assignment  table 
which  is  easily  adjusted  to  the  requirements  of  a  particular 
installation. 
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Programs  compiled  by  the  processor  make  use 
of  a  library  of  subroutines  called  the  MILITRAN  Object- 
Tlme  Library,  Since  one  or  more  of  these  programs  may 
be  required  to  run  a  given  program.  It  Is  anticipated  that 
Installations  using  MILITRAN  frequently  will  wish  to  add 
the  MILITRAN  Object-Time  Llbrai^y  to  their  monitor  tapes. 

Such  Inclusion  requires  only  that  duplication  of  entity 
names  be  eliminated  from  the  combined  libraries. 

The  dependence  of  the  processor  upon  the  monitor 
system  Is  limited  to  the  use  of  a  few  monitor  locations 
and  the  BSS  Loader,  Installations  using  a  modified  monitor 
system  will  In  most  oases  find  no  need  to  alter  the  processor. 
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Tape  Assignments 

Tapes  used  by  the  processor  are  tabulated 
according  to  function  below.  Hie  shorter  designations 
in  parentheses  will  be  used  throughout  this  manual. 

Unit  Function  (Short  Name) 

A1  FORTRAN  Monitor  System  (System  Tape) 

A2  Symbolic  Input  Tape  (Input  Tape) 

A3  Listing  Output  Tape  (Listing  Tape) 

A4  MILITRAN  Processor  Tape  (Chain  Tape) 

A5  MILITRAN  Intermediate  Tape  1  (Scratch  Tape  1) 

B1  MILITRAN  Intermediate  Tape  2  (Scratch  Tape  2) 

B2  Dump  Program  Intermediate  Tape  (Dump  Tape) 

B3  MILITRAN  Intermediate  Tape  3  (Scratch  Tape  3) 

B4  Punched  Output  Tape  (Punch  Tape) 

B5  MILITRAN  Compiled  Output  Tape  (FAP  Tape) 

Tapes  B2  and  B4  are  not  used  by  the  processor  but 
have  been  reserved  because  of  their  functions  within  the 
monitor  system.  The  availability  of  B2  facilitates  dumping 
in  the  event  of  a  malfunction,  and  use  of  B5  rather  than  b4 
for  compiled  output  enables  the  programmer  to  compile  and 
assemble  MILITRAN  source  programs  in  a  single  monitor  run. 
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PROCESSOR  OUTPUT 

Tlie  many  references  to  ”compllatlon”  and  "com¬ 
plied  output"  In  this  manual  necessitate  an  early  defini¬ 
tion  of  the  processor  output,  llils  subsection  describes 
the  Items  produced  during  the  compilation  process.  Except 
where  specifically  stated  otherwise,  the  order  In  which 
Items  are  described  Is  the  order  In  which  they  are  produced. 

Source  Program  Listing 

The  source  program  being  compiled  Is  copied  onto 
the  Listing  Tape  In  an  expanded  format.  This  expanded  format 
separates  the  statement  label,  continuation  column,  the 
statement,  and  source  card  Identification  fields  for  Increased 
readability.  Each  line  of  the  source  program  listing  Is 
numbered  In  order  to  provide  a  reference  for  possible  diag¬ 
nostics. 


Errors  discovered  during  the  Initial  processing  of 
a  statement  are  noted  by  diagnostic  comments.  Immediately  below 
the  offending  statement.  The  statement  Itself  Is  listed  also, 
blanks  and  comments  having  been  removed. 

Alphabetic  Symbol  Table 

A  list  of  all  names  used  In  the  source  program  Is 
produced  In  alphabetical  order  on  the  Listing  Tape.  Each 
name  Is  accompanied  by  the  numeric  "Internal  symbol"  which 
Is  used  to  denote  that  name  In  the  compiled  PAP  program. 
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Diagnostics 

Source  program  statements  and  overall  structure 
are  checked  at  numerous  points  in  the  processor.  In  order 
to  provide  the  programmer  with  as  much  diagnostic  informa¬ 
tion  as  possible  within  a  single  run  of  the  processor, 
processing  is  continued  to  completion  regardless  of  the 
number  of  errors  found.  Erroneous  statements  are  either 
wholly  or  partially  ignored  during  compilation. 

Although  continuation  of  processing  tends  to  re¬ 
duce  the  number  of  runs  required  to  check  out  a  program, 
the  omission  of  erroneous  statements  may  result  in  "false" 
diagnostics.  Each  diagnostic  comment  should  therefore  be 
intez*preted  with  this  possibility  in  mind. 

If  errors  have  been  discovered  during  generation 
of  the  Source  Program  Listing,  a  warning  flag  to  that  effect 
is  written  on  the  Listing  Tape  immediately  following  the 
Alphabetic  Symbol  Table. 

Errors  discovered  during  intermediate  processing 
are  noted  on  the  Listing  Tape  following  the  Alphabetic 
Sjrmbol  Table.  Where  relevant,  the  line  number  of  the  first 
card  of  the  erroneous  statement  is  given.  Similarly,  errors 
discovered  during  generation  of  the  compiled  PAP  program  are 
listed  immediately  following  the  PAP  Program  Listing. 
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System  Symbol  List 

A  list  of  all  names  used  In  the  source  program 
which  have  a  pre-deflned  meaning  to  the  processor  Is  written 
on  the  Listing  Tape  In  order  of  their  numeric  "internal 
symbols,"  Certain  symbols,  such  as  "RANDOM"  and  "MINIMUM 
INDEX,"  may  appear  in  this  list  because  of  their  implicit 
use  In  the  source  program,  aven  though  they  do  not  appear 
explicitly. 

Numeric  Symbol  Table 

A  list  of  all  source  program  names  which  do  not 
have  a  pre-deflned  meaning  to  the  processor  Is  written  on 
the  Listing  Tape  In  order  of  their  numeric  "Internal  symbols," 
Each  symbol  Is  described  as  to  type,  mode,  storage  area,  and 
dependence  upon  symbolic  dimensions.  Dummy  variables  used  as 
procedure  arguments  are  so  noted.  External  names  are  also 
given  for  reference. 

External  Procedure  List 

External  procedures  which  are  used  by  the  source 
program  are  listed  In  numeric  order.  Procedures  which  appear 
In  the  MILITRAN  Object-Time  Library  are  not  listed.  External 
procedure  names  exceeding  six  characters  in  length  are  trun¬ 
cated  to  six  characters. 
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symbolic  Dimension  List 

All  symbolic  dimensions  whose  values  are  to  be 
specified  at  running  time  are  listed  In  the  order  In  which 
they  must  be  presented  to  the  program.  Since  storage 
assignment  Is  accomplished  at  the  beginning  of  main  pro¬ 
grams  only,  this  list  does  not  appear  In  compilation  of 
procedures . 

Cards  specifying  symbolic  dimension  values  are 
prepared  directly  from  this  list.  Each  symbolic  dimension 
value  requires  one  Input  card. 

An  Initializing  value  for  the  system  random  num¬ 
ber  generator  Is  constructed  from  two  Input  values  which 
are  treated  by  the  processor  as  symbolic  dimension. 

FAP  Program  Listing 

PAP  card  Images  comprising  the  compiled  source 
program  are  written  on  the  PAP  Tape.  Each  program  Is  pre¬ 
ceded  by  an  end-of-flle  mark,  and  an  end-of-flle  follows 
the  last  program  written  on  the  PAP  Tape  during  a  given  run 
of  the  processor. 

PAP  card  Images  written  on  the  PAP  Tape  are  also 
copied  onto  the  Listing  Tape.  The  appearance  of  the  state¬ 
ment  ’’SUSPEND  PAP  LISTING”  anywhere  In  the  source  program 
will  cause  this  listing  to  be  deleted. 
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Printer  Comments 

V/hen  compilation  of  a  source  program  Is  Initiated 
by  the  processor,  the  legend 

"BEGIN  MILITRAN  COMPILATION" 

Is  printed  on-line.  At  the  conclusion  of  each  compilation, 
the  comment 


"xx  ERRORS  IN  ABOVE  COMPILATION" 

appears.  The  letters  "xx"  are  replaced  by  the  letters  "NO" 
or  the  number  of  diagnostic  comments  Issued  during  process¬ 
ing. 

At  the  conclusion  of  a  processor  run,  the  number 
of  "BEGIN"  comments  vflll  equal  the  number  of  file  marks  on 
the  PAP  tape.  The  number  of  "ERROR"  comments  will  equal  the 
number  of  programs  actually  compiled. 

Pagination 

Output  on  the  Listing  Tape  Is  separately  paginated 


for  each  program  compiled. 
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PROCESSOR  STRUCTURE 

The  7090  MILITRAN  ProcesBor  operates  as  a  four- 
link  chain  job,  chain  links  being  stored  on  the  Chain  Tape. 
Processing  proceeds  In  four  phases  or  "passes,”  Appendix 
3  provides  a  general  description  of  the  functions  of  each 
pass. 


Passes  and  chain  links  do  not  correspond  exactly. 
Passes  I  and  II  are  In  the  core  simultaneously;  Pass  III 
constitutes  one  link;  Pass  IV  Involves  two  links. 
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PROGRAMMING  THE  7090  IN  MILITRAN 

This  section  deals  with  aspects  of  processor 
operation  of  Interest  primarily  to  the  programmer.  The 
mechanics  of  deck  preparation  for  compiling,  assembling, 
and  executing  MILITRAN  programs  on  the  709O  are  described. 
Programming  considerations  which  apply  to  the  7090  version 
of  MILITRAN  are  discussed. 

The  subsections  which  follow  assume  that  the 
reader  Is  familiar  with  the  rudiments  of  operation  under 
the  Fortran  Monitor  System.  Complete  Information  on  this 
system  from  a  programming  viewpoint  Is  available  In  IBM 
Publication  Number  C28-6054-2:  Reference  Manual,  709/7090 
FORTRAN  Programming  System. 


PREPARATION  OF  DECKS  FOR  COMPILATION 

Deck  configurations  for  translation  of  MILITRAN 
source  programs  Into  FAP  are  described  In  this  subsection. 
The  basic  deck  Is  described  plctorlally  under  "Prototype 
Deck."  Details  of  deck  components  follow. 
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Prototype  Deok 
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Identification  and  Instructions 

Requirements  for  the  *I,D,  card  are  determined 
by  the  accounting  routine  In  use  at  the  machine  Installa¬ 
tion. 

Instructions  to  the  machine  operator  might  In¬ 
clude  a  request  to  mount  the  MILITRAN  Processor  Tape  and 
required  Intermediate  tapes;  Instructions  for  listing 
and/or  punching  of  output  data  off-line;  and  programmer 
comments  regarding  the  nature  of  the  run. 

The  monitor  control  card  "*  PAUSE"  Is  usually 
Included  to  permit  required  tape  handling  by  the  operator. 
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In  general,  all  Identification  and  Instruction 
requirements  are  determined  by  operating  procedures  In 
effect  at  each  Installation. 

Start  Deck 

The  "Start  Deck"  Initiates  operation  of  the 
processor.  A  standard  Start  Deck  Is  provided  with  the 
MILITRAN  system  and  consists  of  four  cards :  the  monitor 
control  card  "*  XEQ";  a  two-card  binary  program  which  re¬ 
winds  the  Chain  Tape  and  Listing  Tape  and  Initiates 
processor  operation;  and  the  monitor  control  card  "*  DATA," 

The  binary  program  which  Initiates  processing 
does  so  through  execution  of  the  Instruction  sequence  "CALL 
CHAIN  (l,t)."  Any  program  which  logically  concludes  with 
this  sequence  may  be  used  In  the  Start  Deck  If  desired. 

The  Integer  "t"  should  be  set  to  the  logical  unit  designa¬ 
tion  of  tape  unit  a4. 

Source  Programs 

Any  number  of  source  programs  may  be  processed 
during  a  single  processor  run,  provided  that  the  capacity 
of  the  PAP  tape  Is  not  exceeded.  Each  source  program  must  be 
terminated  by  an  END  COMPILATION  statement.  Statements  which 
are  erroneously  placed  between  the  last  END  COMPILATION  card 
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and  the  end  of  the  deek  will  be  listed,  but  are  not  ooroplled 
as  a  source  program. 

A  three -character  prefix  for  serialization  of 
PAP  output  and  binary  cards  Is  copied  exactly  from  columns 
73-75  of  the  END  COMPILATION  card  for  each  program  compiled. 
Thus,  If  source  program  cards  are  serialized  In  card  columns 
73-80,  PAP  and  binary  cards  will  bear  Identical  codes  In 
columns  73-75. 
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PREPARATION  OP  DECKS  FOR  ASSEMBLY 

Two  methods  are  available  for  assembly  of 
MILITRAN  compiled  programs.  Card  Images  from  the  PAP 
Tape  may  be  punched  off-line  and  assembled  as  any  other 
PAP  programs,  or  assembly  may  be  performed  directly 
from  the  PAP  Tape,  Both  methods  are  discussed  In  this 
subsection. 

Assembly  from  Cards 

Programs  written  on  the  PAP  Tape  contain  all 
Information  required  by  the  PAP  assembler.  Only  the 
monitor  control  card  '*♦  PAP"  need  be  provided  for  each 
program  to  be  assembled.  A  typical  assembly  deck  Is 
shown  plctorlally  below. 
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Whan  requesting  off-line  punching  from  the 
PAP  Tape,  the  number  of  files  to  be  punched  should  be 
one  greater  than. the  number  of  programs,  since  a  file 
mark  precedes  the  first  program. 

Assembly  from  Tape 

Assembly  of  programs  directly  from  the  PAP 
Tape  Is  possible  through  the  use  of  the  update  features 
of  the  PA?  assembler.  Complete  programming  Information 
regarding  the  update  facility  Is  available  In  IBM 
Publication  Number  C28-6235:  Reference  Manual,  IBM  709/7090 
Programming  Systems;  PORTRAN  Assembly  Program  [pAP]  . 

The  following  sequence  of  monitor  control  cards 
and  PAP  pseudo-instructions  will  cause  assembly  of  one  pro¬ 
gram  from  a  properly  positioned  PAP  Tape; 


15  ?r 

1  7 

-Q  5- 

8  5 

1  7 

6  2 

7  8" 

3  0 

« 

PAP 

UPDATE 

END 

t 

aaa99990 

The  Integer  ‘*t”  must  be  the  logical  unit  designation  of  the 
PAP  Tape,  and  the  prefix  ''aaa''  must  correspond  to  that  copied 
from  the  END  COMPILATION  card  of  the  MILITRAN  source  program. 


■  X8 


Proper  tape  positioning  requires  that  programs  be  assembled 
In  the  order  compiled,  or  that  the  programmer  familiarize 
himself  with  the  PAP  update  feature. 

Assuming  that  the  PAP  Tape  Is  mounted  on  logical 
unit  10  and  Is  rewound,  the  following  deck  would  assemble 
the  first  two  programs  on  the  tape: 


END 


UPDATE  10 


♦  FAP 

CNO  Ma 

UPDATE  10 

1 

#FAP 

1 

♦  1.0.  ^ 

ios 


On  occasion.  It  may  be  desired  to  assemble  only 
certain  programs  from  the  PAP  Tape.  The  following  sequence 
will  cause  assembly  of  a  particular  program  from  logical 


unit  10: 
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0  0 

1  7 

0  1 

8  5 

1  7 

6  2 

7  8 

3  0 

* 

PAP 

UPDATE 

SKIPTO 

END 

IP 

aaaOOOlO 

aaa99990 

Again,  the  prefix  "aaa"  must  be  unique  and  correspond  to 
the  serialization  prefix  of  the  program  to  be  assembled. 
Proper  tape  positioning  requires  that  assemblies  be  per¬ 
formed  In  order  of  calculation. 

It  Is  recommended  that  programmers  using  the 
7090  MILITRAN  Processor  study  the  use  of  the  update  facili¬ 
ty  In  the  PAP  manual.  Considerable  flexibility  In  handling 
compiler  output  will  result. 
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PREPARATION  OP  DECKS  FOR  EXECUTION 

Deck  configurations  for  execution  of  MILITRAN 
programs  are  similar  to  all  others  used  with  the  FORTRAN 
Monitor  System.  A  typical  configuration  Is  shown  plc- 
torlally  below,  and  discussion  of  deck  components  follows: 

Prototype  Deck 
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Monitor  Control  Cards 

The  three  control  cards  *I.D.,  *XEQ,  and  *DATA 
are  required  for  every  run.  Additional  comment  cards  may 
appear  after  the  *I.D,  card  If  desired. 

Main  Program,  Subroutines,  and  Library 

Although  the  positions  of  the  various  binary 
decks  relative  to  each  other  are  not  significant,  all  bina¬ 
ry  decks  must  Immediately  preceed  the  *DATA  card.  One  and 
only  one  of  these  decks  must  be  a  main  program.  All  others 
must  be  subroutines. 

A  detailed  summary  of  the  MILITRAN  Object-Time 
Library  will  be  found  In  Appendix  1.  If  this  library  la 
Included  on  the  Installation's  System  Tape,  binary  decks 
for  required  library  subroutines  need. not  be  Included  In 
the  deck  configuration.  Otherwise,  each  library  subroutine 
used  by  the  program  must  be  present. 

Where  computer  storage  Is  not  at  a  premium,  the 
entire  MILITRAN  Object-Time  Library  may  be  Included  In  the 
deck.  This  eliminates  the  need  for  determining  the  specific 
subroutines  required  by  the  program.  Inclusion  of  the  en¬ 
tire  library  uses  approximately  4200  core  locations. 


22 


Symbol Jc  Dlmenalona 

Cards  bearing  symbolic  dimension  values  must 
appear  in  exactly  the  same  order  as  the  Symbolic  Dimension 
List  produced  during  compilation.  Each  card  must  contain 
a  decimal  Integer,  the  Integer  being  right- justified  in 
card  columns  1-5.  Card  columns  6-80  are  ignored  by  the 
program. 

Input  Data 


Input  data  foz*mat  Is  determined  entirely  by  the 
MILITRAN  programmer,  Die  first  card  of  Input  data  must 
Immediately  follow  the  last  symbolic  dimension  card,  or 
the  *DATA  card  if  no  symbolic  dimensions  are  required. 
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EXAMPLES  OP  TYPICAL  MILITRAN  DECKS 

The  examples  of  deck  configurations  given  in 
this  subsection  are  intended  as  guides  to  the  programmer 
in  arranging  MILITRAN  programs  for . compilation,  assembly, 
and  execution.  In  all  cases  it  is  assumed  that  desired 
processing  is  to  be  accomplished  in  a  single  monitor  run. 

Compile  One  Program 

The  example  below  Illustrates  a  deck  to  compile 
a  single  program.  PAP  output  will  be  serialized  with  the 
prefix  "SRO". 
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Compile  and  Assemble  Programs 

Hie  example  below  Illustrates  a  deck  configu¬ 
ration  to  compile  and  assemble  two  programs,  END  COMPI¬ 
LATION  cards  are  not  serialized,  and  PAP  cards  will  there¬ 
fore  have  blanks  In  card  columns  73~75« 
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Compile  Three  Programs.  Assemble  Two 

Hie  example  below  Illustrates  a  deck  configu¬ 
ration  to  compile  three  programs  and  assemble  the  first 
and  last  of  these.  Card  serialization  Is  obviously 
necessary  In  this  Instance. 


END 


SKIPTO 


ccc»t«tds 
cccoooioX 


UPDATE  to 


N  PAP 


END 


SKIPTO 


AAASOOOdS 

AAAOOOldS 


UPDATE  10 


«  FAP 


’\ 


ft  1.0. 


END  compilation  CCCS| 


prt^rMi 


z; 


CNO  COMmLATION  BBBSj 

==^ 


END  COMPUTATION  AAA\ 


z 


prftftrMi 


z 


Start  Sacli 


ft  IfistriKtlons 


ft  1.0. 


1/ 
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Compile,  Assemble «  and  Execute 

The  example  below  Illustrates  a  deck  configu¬ 
ration  to  compile,  assemble,  and  execute  a  main  program 
and  two  subroutines.  The  END  COMPILATION  cards  are  not 
serialized;  the  entire  library  has  been  Included;  and  no 
symbolic  dimensions  have  been  used. 


Input  doto 


«  DATA 


LItrdry  ibinory) 


CNO 


999  9&\ 


UPOATC  10 


#  FAP 


CNO 


•  999<K 


UPOATC  10 


«  FAP 


CNO 


99990\ 


UPOATC  10 


«  FAP 


«  xco 


«  1.0. 


CNO  OOMPILATION 


Su^rsutlM  2 


CNO  compilation 


Stf^rsutlns  1 


CNO  compilation 


z 


Mdln  proQrdni 


ttcrt  dsek 


9  Instrusttsnt 


9  1.0. 


V 


y 


1/ 
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CHAIN  JOBS 

The  CHAIN  feature  of  the  atandaz^d  monitor  eyatem 
may  be  uaed  to  permit  execution  of  prograraa  whoae  atorage 
requlrementa  exceed  the  alze  of  the  computer.  Decka  for 
execution  of  CHAIN  Joba  are  aet-up  In  MILITRAN  In  the  aame 
manner  aa  In  FORTRAN,  The  aequenclng  atatement  "CALL  CHAIN 
(R,T)"  uaed  In  FORTRAN  la  replaced  In  MILITRAN  by  "EXECUTE 
CHAIN  (R,T)". 

Certain  characterlatlca  of  MILITRAN  programs  dic¬ 
tate  the  following  conalderatlona  with  reapect  to  chaining: 

1.  Symbolic  dlmenalona.  If  uaed,  should 
appear  In  COMMON, 

2.  Only  one  main  program  should  contain 
symbolic  dimension  references  or  the 
system  function  "RANDOM",  This  main 
program  should  be  entered  only  once, 

3.  Use  of  arithmetic  expressions  as  di¬ 
mensions  should  be  avoided. 

As  program  structure  la  readily  arranged  to  comply  with 
the  above  miles,  no  limitation  upon  chaining  procedures 
Is  Implied. 


28 


USE  OP  NON-MILITRAN  CODINQ 

Under  some  olroumetanoeSj  the  programmer  may 
wlah  to  incorporate  non-MILITRAN  coding  aectiona  in  a 
MILITRAN  program,  or  use  MILITRAN  to  generate  portions  of 
non-MILITRAN  programs.  Information  contained  in  this  sub¬ 
section  will  facilitate  "hybrid"  programming  where  desired. 

Insertion  of  FAP  Coding  in  MILITRAN  Programs 

Uie  output  of  the  7090  MILITRAN  Processor  is  a 
PAP  program  embodying  the  algorithm  originally  expressed 
in  MILITRAN,  Alterations  to  this  program  may  be  made  in 
PAP  provided  that  the  coding  sequences  of  the  original 
program  are  understood. 

Variable  names  in  the  compiled  program  have  the 
form  "(n),"  where  "n"  la  the  internal  symbol  assigned  by 
the  processor.  Correspondence  between  internal  and  external 
names  is  found  in  both  the  Alphabetic  and  Numeric  Symbol 
Tables  produced  during  compilation.  Temporary  storage  lo¬ 
cations  are  denoted  by  ",Tx,  -  n",  where  n  >  1  and  1  <  x  <  4, 
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Access  to  data  In  airrays,  vectors,  and  lists 
Is  accomplished  by  means  of  Indirect  addressing  through 
"declaration  tables,"  The  structure  of  these  tables  Is 
summarized  In  Appendix  2.  Relative  positions  of  data  are 
carried  In  Index  Register  2,  Index  registers  are  saved 
where  possible  within  a  given  source  statement,  but  are 
not  generally  carried  from  one  source  statement  to  another. 

Subroutine  Calling  Sequences 

The  source  statement 

EXECUTE  SUBR(A,B,C,D) 

In  a  MILITRAN  program  will  produce  a  PAP  sequence  of  the 
foxTn 


TSX 

$SUBR,4 

BRN 

(a) 

BRN 

(b) 

BRN 

(c) 

BRN 

(d) 

where  (a,b,o,d)  are  the  Internal  symbol  numbers  corre¬ 
sponding  to  (A,B,C,D). 
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PAP  coded  subroutines  compatible  with  the  above 
calling  sequence  may  be  executed  by  MILITRAN  programs. 
Where  all  arguments  are  single  arithmetic  variables, 
PORmAN  II  and  MILITRAN  subroutines  may  also  be  used  to¬ 
gether.  It  should  be  remembered,  however,  that  integer 
values  stored  by  POR'niAN  II  programs  will  appear  to  be 
262,144  times  their  actual  value  when  Interpreted  by 
MILIIRAN  programs,  Uils  factor  of  2'‘‘  is  due  to  the 
fact  that  FORTRAN  II  does  not  utilize  the  full  word  length 
in  manipulating  Integer  quantities. 
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MACHINE  DEPENDENCE 

•nie  MILITRAN  Basic  Language  Is  generally  Inde¬ 
pendent  of  hardware  characteristics.  Some  features  em¬ 
bodied  In  the  processor  are,  however,  peculiar  to  the 
7090/709^,  and  some  programming  techniques  may  limit 
machine  Independence. 

Machine  Oriented  Features 

The  statement  "SUSPEND  PAP  LISTING"  and  seri¬ 
alization  prefix  specification  on  the  "END  COMPILATION" 
card  are  features  of  the  7090  MILITRAN  Processor.  They 
should  not  be  considered  as  elements  of  the  MILITRAN 
Basic  Language. 

Input/output  statements  such  as' "UNLOAD"  are 
meaningful  only  when  tape  drives  permit  such  operations 
to  be  executed  by  the  computer  program. 

Auxiliary  listings  produced  during  compilation 
are  features  of  the  processor  alone. 

Programming  Techniques 

Use  of  non-MILITRAN  coding  will  obviously  limit 
the  case  with  which  a  program  can  be  Implemented  on  another 
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computer.  This  limitation  Is  therefore  Incurred  with 
the  specific  knowledge  of  the  programmer, 

A  more  subtle  form  of  machine  dependence  arises 
as  the  programmer  gains  experience  with  the  processor  and 
the  language.  It  Is  only  natural  that  certain  cause-and- 
effect  relationships  will  be  noted  between  MILITRAN  Source 
Programs  and  the  PAP  programs  produced  from  them,  V/hen 
the  programmer  takes  advantage  of  his  familiarity  with  the 
processor  In  coding  MILITRAN  programs,  loss  of  machine 
independence  may  result. 

All  possible  techniques  of  source  language  coding 
cannot  be  anticipated  In  the  design  of  a  processor,  and 
even  grotesque  distortions  of  a  language  may  at  some  time 
be  employed  to  advantage.  Considerable  effort  has  been 
devoted  to  keeping  the  language  and  the  processor  free  of 
unnecessary  restrictions,  Vfhere  machine  independence  Is 
of  secondary  Importance,  the  programmer  Is  free  to  break 
rules , 
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OPERATINQ  TOE  7090  MILITRAN  PROCESSOR 

Ihla  section  deals  with  aspects  of  processor 
operation  of  Interest  primarily  to  the  machine  operator. 
Tape  requirements,  overall  processing  sequence,  and  error 
procedures  are  discussed. 

GENERAL  OPERATINQ  PROCEDURES 

In  general,  the  processor  operates  as  any  other 
monitor  Job.  Specific  operating  characteristics  are  dis¬ 
cussed  In  this  subsection. 

Tape  Set-up 

Hie  processor  requires  mounting  of  the  MILITRAN 
Processor  Tape  on  a4,  and  scratch  tapes  on  A5  and  B5.  "nie 
Processor  Tape  should  be  file  protected. 

All  required  rewinding  of  tapes  Is  performed  by 
the  processor.  In  addition,  a4  will  unload  at  the  end  of 
a  processor  run.  Since  other  monitor  functions  may  use 
a4,  this  feature  provides  additional  protection  for  the 
processor  and  convenience  In  tape  handling  for  the  machine 
operator. 


34 


If  the  end-of-tape  mark  la  paaaed  while  writing 
A3<  and  end-of-flle  la  written  and  A3  unloada,  Itie  proceaaor 
halta  after  printing  a  requeat  for  a  new  A3.  Prooeaalng 
reaumea  when  START  la  preaaed, 

Keya.  Senae  Swltehea.  Senae  Llghta 

No  aenae  awltchea  are  read  by  the  proceaaor  at 
any  time.  Senae  llghta  are  uaed  only  to  Indicate  the 
current  proceaalng  phaae.  Senae  light  1  la  on  during 
Paaa  I;  aenae  light  2  during  Paaa  II;  etc. 

All  keya  muat  be  clear  during  nox*mal  operation 
of  the  proceaaor.  Keya  are  uaed  to  apeclfy  checkout  and 
eini'or  procedurea  only. 

Printer  Commenta 

» 

Printer  commenta  are  uaed  to  Indicate  the  progreaa 
of  proceaalng,  to  requeat  a  new  A3#  and  to  Indicate  errora 
In  reading  the  MILITRAN  Proceaaor  Tape,  llie  commenta  are 
aelf -explanatory. 

Proceaalng  Sequence 

ISie  overall  aequence  of  proceaaor  operation  la 


aa  followat 
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1.  An  Initialisation  program 
(start  Deck)  la  loaded  into  core 
and  executed. 

2,  Paaees  I  &  II  are  loaded  from  a4 
and  processing  begins. 

3  Intermediate  tapes  Bl,  B3,  and 
A5  are  rewound.  An  end-of-flle 
Is  written  on  B5.  The  comment 
'^EQIN  MILITRAN  COMPILATION"  is 
printed  on-line. 

4.  Source  statements  are  read  from 
A2  until  an  "END  COMPILATION" 
statement  la  encountered.  If  an 
end-of-flle  appears  before  "END 
COMPILATION",  the  processor  re¬ 
winds  B5,  unloads  A4,  and  returns 
control  to  the  monitor. 

5.  If  no  end-of-flle  is  encountered, 
processing  proceeds  through  Pass 
II  and  Pass  III  is  loaded  from  a4. 

6.  When  Pass  III  is  complete.  Pass  IV 
is  loaded  and  A4  rewinds. 
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.  Pass  IV  ends  by  printing  a  state¬ 
ment  on-line  which  contains  the 
number  of  errors  discovered  dur¬ 
ing  processing. 

8,  If  no  errors  have  been  discovered 
by  Pass  IV,  control  returns  to 
step  2,  Otherwise,  the  Pass  IV 
Diagnostic  Processor  Is  loaded 
from  a4  and  executed. 

9.  A4  Is  rewound,  and  control  returns 
to  step  2. 
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ERROR  PROCEDURES 

Thlfl  subsection  describes  procedures  to  be 
followed  In  the  event  of  malfunctions. 

Data  Channel  Traps 

The  processor  uses  buffered  Input/output 
operations  during  all  passes.  As  a  result,  attempts  to 
use  normal  monitor  functions  In  dumping  or  Jettisoning  a 
run  may  be  frustrated  by  enabled  traps.  If  non-MILITRAN 
error  procedures  are  attempted,  press  RESET  In  order  to 
clear  existing  trap  signals  before  starting  the  computer. 

End -of -Tape  Marks 

The  processor  will  not  permit  writing  beyond 
the  end -of -tape  mark  on  any  tape.  If  the  end  of  any  tape 
except  A3  Is  encountered,  the  computer  stops  at  octal  lo¬ 
cation  00025.  Processing  cannot  be  continued.  Press 
RESET  and  Jettison  the  run. 

Redundancy 

The  processor  will  attempt  to  read  or  write  a 
record  ten  times  before  declaring  a  tape  error.  In  the 
event  of  a  tape  error,  the  computer  stops  at  octal  loca¬ 
tion  00024.  Processing  cannot  be  continued.  Press 
RESET  and  Jettison  the  run. 
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Malfunction 

Machine  errors  or  unusual  source  program  errors 
may  cause  the  processor  to  stop  or  loop.  When  such  a 
condition  occurs,  the  following  standard  procedure  should 
be  followed: 

1,  Switch  computer  to  MANUAL, 

2,  Put  keys  S, 1,2,31  and  35  DOWN, 

3,  Copy  the  Instruction  counter  Into 
keys  3  thru  17. 

4,  Press  ENTER  INSTRUCTION, 

5,  Switch  computer  to  AUTOMATIC, 

6,  Press  START, 

7,  When  writing  has  begun  on  A3> 
clear  the  keys. 

The  above  procedure  will  cause  the- contents  of 
the  computer  memory  to  be  dumped  onto  A3  and  control  re¬ 
turned  to  Pass  I, 
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APPENDIX  1 

MILITRAN  OBJECT-TIME  LIBRARY 

The  MILITRAN  Object-Time  Llbraiv  consists  of 
binary  subroutine  decks  which  perform  standard  process¬ 
ing  functions  during  execution  of  MILITRAN  programs. 

The  llbraiv  Is  divided  Into  three  sections  as  follows: 

MLl:  Arithmetic  Functions 

ML2 :  Inpu  t  /Ou  t  pu  t 

ML3:  System  Procedures 

Llbrai^r  decks  are  Identified  by  four -character 
codes  In  columns  73-76  of  the  binary  cards.  The  two  tables 
Included  In  this  appendix  summarize  the  characteristics  of 
each  deck  with  respect  to  MILITRAN  source  codes. 

Hie  LIBRARY  CONTENTS  table  lists  for  each  library 
deck  Its  Identification  code,  core  storage  requirements 
(decimal),  entry -point  names,  other  library  decks  used,  and 
source  program  characteristics  which  require  Its  Inclusion 
at  running  time. 

Hie  LIBRARY  USAGE  table  lists  various  source  pro¬ 
gram  characteristics  and  the  library  routines  required  at 
running  time  In  order  to  Implement  those  characteristics. 
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APPENDIX  g 

DECLARATION  TABLES 

All  objects,  classes,  arrays,  vectors,  and 
lists  are  fully  described  In  the  object  program  by 
means  of  reference  tables.  These  tables  are  described 
In  detail  on  succeeding  pages. 
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Objects 


b-m 


P  2^3 _ 17^18  20|21 _ 35 

Last  word  of  object  name 


b-1 

First  word  of  object  name 

b 

4 

d 

0 

a 

Base  address  b  is  the  location  corresponding  to 
the  Internal  symbol  of  the  object  name.  The  name  of  the 
object  Is  stored  In  BCD  code,  six  characters  to  the  word. 
The  last  word  of  the  name  Is  filled  with  blanks  on  the 
right  If  less  than  six  characters  long.  Decrement  d  Is 
the  number  of  characters  In  the  object  name,  excluding 
blanks. 


If  the  object  was  declared  with  a  symbolic 
dimension,  address  a  Is  the  location  of  the  symbolic 
dimension  value.  The  actual  value  replaces  "a"  after 
dimension  values  are  read. 

If  the  object  was  declared  with  a  numeric  di¬ 
mension,  a  Is  the  value  of  that  dimension. 


^9 


ClasaeB 

b-n 

b-n+1 


b-2 

b-1 

b 

Base  address  b  corresponds  to  the  Internal  symbol 
of  the  class  name.  The  number  of  words  In  the  table,  ex¬ 
cluding  the  base  address.  Is  n.  The  cardinality,  o.  Is 
Initially  zero  If  any  member  of  the  class  Involves  symbolic 
dimensions.  After  symbolic  dimensions  have  been  read,  c  Is 
set  to  the  proper  cardinality. 

Table  words  In  location  b-1  through  b-n  specify 
the  members  of  the  class.  Decrements  d^  through  d^  are 
codes  designating  objects  which  belong  to  the  class,  each 
object  being  designated  by  the  base  address  of  Its  decla¬ 
ration  table  In  core.  Addresses  a^  through  a^  are  the 


P  2 

3  17 

18  20 

21 

35 

'’n 

0 

^n 

Vl 

0 

%-l 

^2 

<>2 

0 

^2 

■Si 

0 

^1 

0 

n 

0 

C 
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reepeotlve  contributions  of  objeotc  through  d^  to  the 
total  cardinality  of  the  clacc.  Pi*«flx  Is  zero  If 
object  d^  Is  Included  collectively  (no  EACH*)  In  the 
class;  p^  Is  four  If  object  d^  Is  Included  Individually 
(EACH*). 
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Arrays 

b-n 

b-n-1 


b-2 

b-1 

b 


Base  address  b  corresponds  to  the  Internal  symbol 
of  the  array  name.  Entries  In  locations  b-1  through  b-n 
specify  the  n  dimensions  of  the  array.  Address  a^  Is  the 
BES  address  of  the  array  Itself.  The  location  specified  by 
a^  Is  also  reserved,  and  Is  called  the  "zero  position." 

Arrays  are  stored  In  decreasing  storage  locations 
from  a^,  the  first  subscript  varying  most  rapidly.  Access 
to  arrays  Is  accomplished  Indirectly  by  means  of  the  tag  t 
which  Is  either  2  or  Is  set  to  2  by  the  storage  allocation 
processing. 


P  2  .3 _ 17,18  20,21 _ ^ 


'■n 

■'n 

0 

^n 

’’n-l 

0 

®n-l 
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If  the  1~  dimension  is  numeric ,  is  zero, 

is  zero,  and  la  the  dimension  value.  If  the  1— 

dimension  is  numeric,  is  4,  d^  is  zero,  and  a^^  is  the 

location  of  the  dimension  value.  The  dimension  value  it¬ 
self  replaces  a^  during  storage  allocation. 

If  the  i—  dimension  is  an  object  or  class  name 
which  does  not  involve  symbolic  dimensions,  p^^  is  zero, 

dj^  is  the  base  address  of  the  object  or  class  in  storage, 

and  a^^  is  the  cardinality  of  the  object  or  class.  If  the 

object  or  class  is  dependent  upon  symbolic  dimensions,  Pj^^ 

is  4  and  a^^  is  zero.  The  cardinality  of  the  class  or  object 

as  determined  by  its  symbolic  dimension  values  replaces 

during  storage  allocation. 
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Vectors 


b  -m  ( n  f  1 ) 


b-(tn-2)(n+l)-l 


17|  18  20^  21 


35 


component 


(m-1 )~  component 


b-n-2 


b-l 

b 


Second  component 


First  component 


m 


H/ 


Each  of  the  m  components  has  n  dimensions  and 
Its  declaration  table  la  Identical  to  that  for  an  array. 
Only  one  "zero  position"  Is  reserved  for  the  entire  vector, 
and  that  position  Is  at  a^.  Tag  t  Is  either  2  or  Is  set 
to  2  during  storage  allocation. 

Vectors  are  stored  In  decreasing  storage  loca¬ 
tions  from  a^.  The  first  component  has  Its  "zero  position" 
at  a^;  the  second  component  shares  Its  "zero  position"  with 
the  last  position  of  the  first  component;  etc. 
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Base  address  b  corresponds  to  the  Internal 
symbol  of  the  vector  name.  The  base  addresses  of  array 
tables  for  components  correspond  to  the  Internal  symbol 
of  the  component  names. 


Lists  and  Permanent  Events  with  Lists 


P  2^3 _ 17^18  20^21  35 


b-3m 

b 

1 - 1 - 1 - 

Vector  table 

b+1 

0 

0 

0 

®-l 

The  "vector  table"  Is  Identical  to  that  for 
vector  having  ra  components  of  one  dimension  each.  The 
address  a_^  at  location  b  +  1  Is  the  current  length  of 
the  list.  This  length  Is  originally  zero. 

Base  address  b  corresponds  to  the  Internal 


symbol  of  the  list  name 
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Contingent  Events  with  Llsto 


P  2^3 _ 17^18  20^21 _ ^ 


b-3ra 

Vector  table 

b 

b+1 

4 

0 

0 

b+2 

0 

0 

0 

^-2 

Location  b  +  2  specifies  the  address  (a_2^ 
the  first  Instruction  In  the  event  processing  sequence* 
Other  locations  In  the  table  are  as  described  under  Lists. 
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APPENDIX  3 

FUNCTIONS  OP  PROCESSOR  PASSES 

Punctlono  of  each  pass  are  described  below. 

Patfses  are  executed  sequentially  for  each  program  com¬ 
piled.  Initiation  and  termination  of  the  operation  of 
the  processor  occurs  in  Pass  I. 

Pass  I 

All  reading  of  the  Input  Tape  is  performed  by 
Pass  1.  Statements  are  numbered  and  copied  onto  the  Listing 
Tape  as  they  are  read.  Buffered  Input/output  operations 
permit  these  functions  to  occur  concurrently  with  Internal 
processing. 

Each  statement  Is  subjected  to  a  general  scan 
which  eliminates  blanks  and  comments.  FORMAT  and  END  COM¬ 
PILATION  statements  are  identified  immediately  and  processed 
separately.  Diagnostics  issued  during  preliminary  scanning 
are  followed  by  a  listing  of  the  scanned  statement  up  to 
the  point  at  which  the  error  is  discovered. 

After  preliminai*y  scanning^  statement  types  are 
identified  and  statements  are  reduced  to  an  internal  code  for 
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proeessing.  All  names  are  assigned  unique  numeric  Identi¬ 
fiers  which  will  become  the  basis  for  Internal  storage  of 
their  declared  characteristics.  Mnemonic  delimiters  such 
as  UNTIL,  FOR,  and  BY  are  Identified. 

Pinal  processing  In  Pass  I  Is  determined  by  the 
type  of  statement.  Symbolic  dimensions  are  Identified  and 
declared.  Statement  labels  are  declared.  FORMAT  state¬ 
ments  are  compressed  and  translated  Into  final  foxnn. 

Declarative  statements  are  written  on  Scratch 
Tape  2j  executable  statements  are  written  on  Scratch  Tape 
3;  certain  "hybrid”  statements  are  written  either  wholly 
or  partially  on  both  tapes.  Names  and  their  Internal  nu¬ 
meric  counterparts  are  written  on  Scratch  Tape  1. 

When  the  END  COMPILATION  statement  has  been 
processed,  the  Alphabetic  Symbol  Table  Is  written  on  the 
Listing  Tape  and  Pass  I  processing  ends.  Ends -of -file  are 
written  on  all  scratch  tapes  and  Scratch  Tape  2  Is  rewound. 

Pass  II 

Declarative  statements  are  read  from  Scratch 
Tape  2  and  processed.  Explicit  declarative  Information  Is 
recorded  In  the  symbol  table  for  later  reference.  Names 
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declared  as  vectors,  lists,  or  events  are  assigned  the 
NORMAL  MODE  If  specific  mode  declarations  are  not  en¬ 
countered.  FORMAT  statements  are  sorted  onto  Scratch 
Tape  3;  expressions  Involving  symbolic  dimensions  onto 
Scratch  Tape  1.  Diagnostics  are  Issued  as  required. 

When  all  declarations  have  been  processed,  the 
symbol  table  Is  scanned  and  adjusted  to  provide  full  In¬ 
formation  regarding  each  explicitly  declared  symbol. 
Diagnostics  are  Issued  without  source  line  references. 

Ends-of-flle  are  written  on  Scratch  Tapes  1  and 
3;  Scratch  Tapes  2  and  3  are  rewound;  Scratch  Tape  1  Is 
backspaced  to  the  beginning  of  the  second  file. 

Pass  III 


All  executable  statements  on  Scratch  Tapes  1  and 
3  are  processed  by  Pass  III.  Each  symbol  whose  mode  has 
not  explicitly  been  defined  Is  assigned  the  NORMAL  MODE. 
Functions  are  Identified.  Hie  Internal  code  In  which  the 
statement  Is  expressed  Is  modified  to  facilitate  further 
processing. 


Statements  are  examined  by  type,  and  complex 
statements  are  rewritten  In  terms  of  more  basic  operations. 
Diagnostics  are  Issued  as  required.  Rewritten  statements 
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are  checked  for  validity  of  Internal  code  symbola  and 
copied  onto  Scratch  Tape  2, 

The  executable  program  written  on  Scratch  Tape  2 
retains  the  basic  syntax  of  the  MILITRAN  source  program. 
However,  certain  statement  types  not  found  In  the  external 
language  have  been  Introduced,  and  many  external  statement 
types  have  disappeared.  Some  temporally  storage  allocation 
has  been  determined;  some  auxiliary  labels  have  been  Intro¬ 
duced,  Constants  retain  the  apparent  mode  specified  by  the 
presence  or  absence  of  a  decimal  point  In  their  external 
form. 


When  all  executable  statements  have  been  processed, 
the  System  Symbol  List  Is  generated.  External  names  are  re¬ 
trieved  from  the  first  file  of  Scratch  Tape  1  and  the  Numeric 
Symbol  Table  Is  written.  Names  of  procedures,  objects,  and 
symbolic  dimensions  are  retained  for  later  reference;  all 
others  are  discarded.  The  External  Procedure  List  and 
Symbolic  Dimension  List  are  written.  Scratch  Tapes  1  and 
2  are  rewound. 

Pass  IV 


Pass  IV  processing  consists  entirely  In  generating 
a  PAP  program  on  the  PAP  tape.  Programs  generated  have  the 
following  canonical  form: 
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1.  A  "LBL"  pseudo-lnstruotlon  eauslng 
binary  cards  to  be  serialized  with 
columns  73-75  of  the  END  COMPILATION 
card. 

2.  A  "COUNT"  pseudo-lnstinictlon  whose 
address  field  Is  seven  times  the 
number  of  cards  In  the  source  pro¬ 
gram, 

3a.  A  page  title  card  and  an  Initial 

transfer  lnstx*uctlon.  (Main  programs 
only . ) 

3b,  An  "ENTRY"  pseudo-lnstinictlon  and  a 
page  title  card.  (Procedures  only.) 

4,  Pseudo-operations  defining  non¬ 
standard  operation  codes  used  In 
compiled  MILITRAN  programs, 

3.  Common  storage  allocation  for  use 
by  MILITRAN  Object -Time  Library 
routines, 

6,  Common  storage  allocation  for  vari¬ 
ables  In  the  source  program.  If 
required. 


6? 


7«  A  one-woiHl  constant  which  provides 
a  link  between  local  and  common 
OBJECT  tables. 

8,  Tables  defining  OBJECTS  In  local 
storage.  If  required, 

9.  System  constant  locations.  If  re¬ 
quired, 

10.  Local  storage  allocation  or  common 
storage  values  for  TIME,  ATTACKER, 
TARGET,  and  INDEX  If  required. 

11.  Local  storage  allocation  and  common 
storage  values  for  all  variables  In 
the  program  as  required. 

12.  FORMATS  specified  In  the  source 
program, 

13.  FORMATS  generated  by  the  processor 
for  listing  of  symbolic  dimensions. 
(Items  13  thru  21  apply  to  main 
programs  only, ) 

14.  A  FORMAT  for  reading  of  symbolic 
dimensions. 
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15,  Symbol -defining  pseudo -operations 
for  use  In  reading  and  writing 
symbolic  dimensions, 

16,  Instructions  which  Initialize  the 
floating-point  trap  routine  and 
common  storage  tables. 

17,  Instructions  which  read  and  list 
symbolic  dimensions. 

18,  Calculation  of  dimension  values 
which  are  arithmetic  expressions, 

19,  Storage  of  dimension  values  In 
reference  tables  for  arrays,  vectors, 
lists,  and  objects. 

20,  Adjustment  of  tables  for  classes 
whose  members  have  symbolic  dimensions. 

21,  Allocation  of  storage  for  arrays, 
vectors,  and  lists  whose  storage 
requirements  depend  upon  symbolic 
dimension  values. 

22,  Processing  specified  by  executable 
statements  In  the  source  program. 


23.  lilxit  aequence  to  monitor  for  main 
programs,  to  calling  program  for 
procedures, 

24.  Instructions  establishing  communi¬ 
cation  between  a  procedure  and  Its 
calling  sequence,  (Procedures  only, ) 

25.  Allocation  of  temporary  storage 
locations. 

26.  "END”  card. 

Diagnostics  Issued  during  Pass  IV  processing  are 
stored  on  Scratch  Tape  1  until  generation  of  the  PAP  pro¬ 
gram  Is  complete,  Ihey  are  then  retrieved  and  expanded 
onto  the  listing  tape. 

All  scratch  tapes  are  rewound  at  the  end  of 
Pass  IV  and  control  Is  returned  to  Pass  I  for  processing 
of  the  next  source  program. 
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APPENDIX  4 

MILITRAN  PROCESSOR  OPERATINQ  SUMMARY 

Tapes 

MILITRAN  Compiler  Tape  on  A4,  file  protected. 

Scratch  tapes  on  A5  and  B5. 

Printer  Comments 

BEGIN  MILITRAN  COMPILATION 
NO  ERRORS  IN  ABOVE  COMPILATION 
XX  ERRORS  IN  ABOVE  COMPILATION 
END  OP  TAPE  A3 
BAD  a4 

Error  Stops 

Location  00024:  Redundancy,  Can  not  be  Ignored,  Kill  Job, 
Location  00025:  End  of  tape.  Can  not  be  Ignored,  Kill  Job, 

Unexpected  Stops 

1,  Switch  to  manual. 

2,  Place  7xx  xxx  000021  In  keys,  where- 

xxxxx  Is  location  counter, 

3.  Press  "ENTER  INSTRUCTION" 

4.  Switch  to  automatic 

5.  Press  "START" 

6,  Clear  keys  after  10  seconds. 

FORTRAN  Monitor  Operations 

Before  attempting  standard  monitor  procedures  such  as 
dumps  or  skipping  to  next  Job,  always  press  RESET, 
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INDEX 

alphabetic  symbol  table  6 
arrays  51-52 
assembly  from  cards  l6-17 
assembly  from  tape  17-19 

BSS  Loader  4 

card  punch  3 

card  reader  3 
chain  Jobs  27 

Chain  Tape  5 

classes  49-50 
COMMON  27 

compiled  output  6-10 

compiled  FAP  program  6,  7,  9,  10 

contingent  events  56 

data  channels  2 
data  channel  traps  37 
diagnostics  6,  7,  10 
Dump  Tape  5 

END  COMPILATION  14-15,  17,  31 
end-of-tape  mark  3^ 

examples  of  typical  decks  12,  13,  I6,  18,  20,  23-26 
execution  of  compiled  programs  20-22 


external  procedure  list  8 


FAP  2,  17 

PAP  coding  Inserted  In  MILITRAN  programs  28 
PAP  program  listing  9 
PAP  Tape  5,  9,  10,  1? 

FORTRAN  Monitor  System  3-4,  12 

hardware  requirements  2-3 

Input  data  22 
Input/output  routines  3 
Input  Tape  5 

instructions  to  operator  13-14 

Integer  conversion  -  FORTRAN  to  MILITRAN  30 

Internal  symbols  for  names  6,  8 

keys  34 

line  printer  2 
links  11 
Listing  Tape  5-9 
lists  55 

machine  errors  38 
main  program  21 

MILITRAN  Object -Time  Library  4,  21,  39-46 
MINIMUM  INDEX  8 


68 


monitor  control  cards  13,  1^,  16,  21 
numeric  symbol  table  8 

objects  48 
operating  summary  65 

pagination  10 

Pass  I  57-58 

Pass  II  58-59 

Pass  III  59-60 

Pass  IV  60-64 

passes  11 

permanent  events  55 

printer  comments  10,  34 

processor  2-11,  34-36 

Punch  Tape  5 

RANDOM  8,  27 

random  number  Initializer  9 
redundancy  errors  37 

Scratch  Tapes  5 
'sense  lights  34 
sense  switches  34 
serialization  15 
software  requirements 
source  program  6 


3-4 


source  program  listing  6 
start  deck  14 
subroutines  21,  29 
SUSPEND  FAP  LISTING  9,  31 

symbolic  dimensions  22 

symbolic  dimension  list  9 
system  symbol  list  8 
System  Tape  5 

tape  set-up  33 

tape  units  2,  3»  5 

UNLOAD  31 
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